Skip to content

docs(ia): reconcile capabilities/ into the 9 pillar folders (one IA, redirected)#628

Merged
rickylabs merged 1 commit into
mainfrom
docs/433-ia-reconcile-capabilities
Jul 11, 2026
Merged

docs(ia): reconcile capabilities/ into the 9 pillar folders (one IA, redirected)#628
rickylabs merged 1 commit into
mainfrom
docs/433-ia-reconcile-capabilities

Conversation

@rickylabs

Copy link
Copy Markdown
Owner

Closes #433

Summary

S0 IA-reconciliation (hard precursor for all #401 C/D docs authoring), per proposal §2.2:

  • All 15 docs/site/capabilities/*.md pages moved content-as-is into their target pillar folders; each old page replaced by a redirect document (layouts/redirect.vto, new) pointing at the canonical pillar path.
  • Every comp.xref cap:* key retargeted to the new pillar paths (_data/xref.ts); _data.ts "Overview & Concepts" cards on the 3 rerouted pillars now point in-pillar.
  • Two net-new navigable stubs: orchestration-runtime/cli-scaffold.md, ai/mcp.md (for workstream D to fill).
  • capabilities/index.md replaced by a redirect after the per-page redirects.

Non-goals honored: no prose rewrites, tutorial-chapter nav anchors untouched, no packages//plugins/ file, no deno.lock churn.

Evidence (worklog: .llm/runs/docs-433-ia-reconcile--codex/worklog.md)

  • deno task verify in docs/site: exit 0 — 23,016 internal links across 162 pages resolve; 27 caveat markers resolve.
  • Built-output redirect inspection: all 15 legacy URLs carry their mapped canonical target (redirects=15 PASS).
  • rg 'capabilities/' docs/site/_data.ts docs/site/_data/xref.ts: clean; 9 pillar headings unchanged in count/order.

CI routing

Docs-only diff (docs/site + run artifacts): applying ci:skip-e2e + ci:skip-scaffold per the harness docs-only rule — the aspire/docker scaffold surface is untouched.

Lane: WSL Codex slice (thread 019f5118-72af…, worktree ns-wt-433) under the beta-7 orchestrator (df71d36c).

@rickylabs rickylabs added this to the 0.0.1-beta.7 milestone Jul 11, 2026
@rickylabs rickylabs added area:docs status:impl-eval type:docs ci:skip-e2e wave:v1 priority:p1 High epic:docs-cut beta.7 docs release cut epic (tutorials + positioning) ci:skip-scaffold Skip the scaffold-static (deno-only) scaffold gate labels Jul 11, 2026
@rickylabs
rickylabs marked this pull request as ready for review July 11, 2026 12:38
@rickylabs
rickylabs merged commit 69e6371 into main Jul 11, 2026
15 of 18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs ci:skip-e2e ci:skip-scaffold Skip the scaffold-static (deno-only) scaffold gate epic:docs-cut beta.7 docs release cut epic (tutorials + positioning) priority:p1 High status:impl-eval type:docs wave:v1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(ia): reconcile capabilities/ into the 9 pillar folders (one IA, redirected)

1 participant